%% Librarian.tex - Librarian chapter
%% Created by Robert Heller on Thu Mar 12 17:55:22 1992
%%
%% ------------------------------------------------------------------
%% Home Libarian by Deepwoods Software
%% ------------------------------------------------------------------
%% Modification History:
%% ------------------------------------------------------------------
%% Contents:
%% ------------------------------------------------------------------
%% 
%% 
%% Copyright (c) 1991,1992 by Robert heller (D/B/A Deepwoods Software)
%%        All Rights Reserved
%% 
%%
\chapter{Searching a Data Base.}
\index{card catalog db@{\bf card catalog db}!searching}
\label{Librarian}

\newcommand{\Librarian}{{\tt Librarian}}

The \Librarian\ program is used to search a data base file.  It is meant
as a eletronic replacement for a card catalog.  It uses a
GUI\footnote{See section~\ref{sec:GUI} for GUI definations.}

\section{Invoking \Librarian.}

\Librarian\  is invoked from the command line:
\begin{verbatim}

Librarian -infile <filename>

\end{verbatim}
where \verb+<filename>+ is the name of the file to be searched.

\section{Using \Librarian.}

When \Librarian\ starts up, it displayes its main menu, as shown in
Figure~\ref{fig:lbmainmenu}.
\begin{figure}
\caption{Main command menu of \Librarian.}
\label{fig:lbmainmenu}
\index{gui@{{\bf GUI} (Graphical User Interface)}!librarian main menu}

\begin{picture}(330,290)
\put(0,0){ \fbox{
\begin{picture}(320,280)

\put(100,256){\tt Main Command Menu}

\put(0,232){\tt Quit}
\put(0,220){\tt List Cards}
\put(0,208){\tt List Titles}
\put(0,196){\tt List Authors}
\put(0,184){\tt List Subjects}

\end{picture}
}}
\end{picture}

\end{figure}

\subsection{The {\tt Quit} Menu Item.}

The {\tt Quit} menu item causes \Librarian\ to close the data base file
and exit.

\subsection{The {\tt List Cards} Menu Item.}\index{card@{\bf card}!finding}

The {\tt List Cards} menu item lists cards with their titles which have
a common selected prefix for their id strings.  You are prompted for a
search prefix and those cards with a matching prefix string in their id
string are listed.  You have the option of displaying a selected
card.

\subsection{The {\tt List Titles} Menu Item.}

The {\tt List Titles} menu item lists titles with a common selected
prefix string.  You are prompted for a search prefix and those titles
with a matching prefix string are listed.  You have the option of
selecting one of the listed titles\footnote{If only one title matches,
it is automatically selected}, in which case the ids for the selected
title are listed (much as in the {\tt List Cards} menu item)\footnote{If
the title only refers to a single card, that card is displayed directly}.

\subsection{The {\tt List Authors} Menu Item.}

The {\tt List Authors} menu item lists authors with a common selected
prefix string.  You are prompted for a search prefix and those authors
with a matching prefix string are listed.  You have the option of
selecting one of the listed authors\footnote{If only one author matches,
it is automatically selected}, in which case the ids for the selected
author are listed (much as in the {\tt List Cards} menu item)\footnote{If
the author only refers to a single card, that card is displayed directly}.

\subsection{The {\tt List Subjects} Menu Item.}

The {\tt List Subjects} menu item lists subjects with a common selected
prefix string.  You are prompted for a search prefix and those subjects
with a matching prefix string are listed.  You have the option of
selecting one of the listed subjects\footnote{If only one subject matches,
it is automatically selected}, in which case the ids for the selected
subject are listed (much as in the {\tt List Cards} menu item)\footnote{If
the subject only refers to a single card, that card is displayed directly}.


